---
title: Déployer votre Site Astro avec Vercel
description: Comment déployer votre site Astro vers le web sur Vercel.
type: deploy
i18nReady: true
---
import ReadMore from '~/components/ReadMore.astro'

Vous pouvez utiliser [Vercel](http://vercel.com/) pour déployer un site Astro vers son global edge network (réseau périphérique mondial) sans aucune configuration.

Ce guide comprend des instructions pour le déploiement vers Vercel via l'interface utilisateur du site web ou le CLI de Vercel.

## Configuration du projet

Votre projet Astro peut être déployé sur Vercel en tant que site statique, ou en tant que site rendu côté serveur (SSR).

### Site Statique

Votre projet Astro est un site statique par défaut. Vous n'avez besoin d'aucune configuration supplémentaire pour déployer un site Astro statique sur Vercel. 

### Adapteur pour SSR

Pour activer le SSR dans votre projet Astro et le déployer sur Vercel:

Ajoutez [l'adapteur Vercel](/fr/guides/integrations-guide/vercel/) pour activer le SSR dans votre projet Astro avec la commande `astro add` suivante. Ceci installera l'adapteur et apportera les changements appropriés à votre fichier `astro.config.mjs` en une seule étape.

```bash
npx astro add vercel
```

Si vous préférez installer l'adaptateur manuellement, suivez les deux étapes suivantes :

1. Installez [l'adapteur `@astrojs/vercel`](/fr/guides/integrations-guide/vercel/) dans les dépendances de votre projet en utilisant votre gestionnaire de paquets préféré. Si vous utilisez npm ou si vous n'êtes pas sûr, exécutez ceci dans le terminal :

    ```bash
      npm install @astrojs/vercel
    ```

1. Ajoutez deux nouvelles lignes à votre fichier de configuration `astro.config.mjs`.

    ```js title="astro.config.mjs" ins={2, 5-6}
    import { defineConfig } from 'astro/config';
    import vercel from '@astrojs/vercel/serverless';

    export default defineConfig({
      output: 'server',
      adapter: vercel(),
    });
    ```

## Comment déployer

Vous pouvez déployer Vercel via l'interface utilisateur du site web ou en utilisant l'interface de ligne de commande (CLI) de Vercel. La procédure est la même pour les sites statiques et les sites Astro SSR.

### Déploiement via l'interface utilisateur du site web

1. Poussez votre code vers votre dépôt Git en ligne (GitHub, GitLab, BitBucket).
2. [Importez votre projet](https://vercel.com/new) dans Vercel.
3. Vercel détectera automatiquement Astro et configurera les bons paramètres.
4. Votre application est déployée ! (ex : [astro.vercel.app](https://astro.vercel.app/))

Une fois que votre projet a été importé et déployé, tous les pushes ultérieures vers les bracnhes généreront des [Déploiements de prévisualisation (EN)](https://vercel.com/docs/concepts/deployments/environments#preview), et toutes les modifications apportées à la branche de production (communément appelée "main") donneront lieu à un [Déploiement de production (EN)](https://vercel.com/docs/concepts/deployments/environments#production).

<ReadMore>Apprenez-en plus sur l'[Intégration Git de Vercel (EN)](https://vercel.com/docs/concepts/git).</ReadMore>


### Déploiement via ILC

1. Installez la [CLI de Vercel](https://vercel.com/cli) et exécutez `vercel` pour déployer.

    ```bash
    npm install -g vercel
    vercel
    ```

2. Vercel détectera automatiquement Astro et configurera les bons paramètres.
3. Lorsqu'il sera demandé `Want to override the settings? [y/N]` (Souhaitez-vous annuler les réglages), sélectionner `N`.
4. Votre application est déployée ! (ex : [astro.vercel.app](https://astro.vercel.app/))


### Configuration avec with vercel.json

Vous pouvez utiliser `vercel.json` pour surcharger le comportement par défaut de Vercel et pour configurer des paramètres supplémentaires. Par exemple, vous pouvez souhaiter attacher des en-têtes aux réponses HTTP de vos déploiements. 

<ReadMore>En savoir plus sur la [configuration Vercel (EN)](https://vercel.com/docs/project-configuration).</ReadMore>

### Mise à jour vers Astro 2.0

Astro v2.0 ne supporte plus Node 14, assurez-vous donc que votre projet utilise **Node `18.14.1` ou plus récent**. Vous pouvez [définir la version de Node.js (EN)](https://vercel.com/changelog/node-js-version-now-customizable-in-the-project-settings)utilisée pendant l'étape de construction et les fonctions Serverless à partir de la page General sous Project Settings.
